From 82a56fd6086071926378ba51d62f6beb417878b1 Mon Sep 17 00:00:00 2001 From: Florian Merz Date: Thu, 11 Feb 2021 14:47:18 +0100 Subject: unslug he: move --- .../manifest.json/permissions/index.html | 198 +++++++++++++++++++++ .../index.html" | 198 --------------------- .../mozilla/add-ons/webextensions/tips/index.html | 57 ++++++ .../index.html" | 57 ------ 4 files changed, 255 insertions(+), 255 deletions(-) create mode 100644 files/he/mozilla/add-ons/webextensions/manifest.json/permissions/index.html delete mode 100644 "files/he/mozilla/add-ons/webextensions/manifest.json/\327\224\327\250\327\251\327\220\327\225\327\252/index.html" create mode 100644 files/he/mozilla/add-ons/webextensions/tips/index.html delete mode 100644 "files/he/mozilla/add-ons/webextensions/\327\230\327\231\327\244\327\225\327\235/index.html" (limited to 'files/he/mozilla') diff --git a/files/he/mozilla/add-ons/webextensions/manifest.json/permissions/index.html b/files/he/mozilla/add-ons/webextensions/manifest.json/permissions/index.html new file mode 100644 index 0000000000..9221f0cf8c --- /dev/null +++ b/files/he/mozilla/add-ons/webextensions/manifest.json/permissions/index.html @@ -0,0 +1,198 @@ +--- +title: הרשאות +slug: Mozilla/Add-ons/WebExtensions/manifest.json/הרשאות +tags: + - manifest.json + - הפניה + - הרחבות + - הרחבות רשת + - הרשאות + - תוספים +translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/permissions +--- +

{{AddonSidebar}}

+ + + + + + + + + + + + + + + + +
טיפוסArray
חובהלא
דוגמה + 
+"permissions": [
+  "*://developer.mozilla.org/*",
+  "webRequest"
+]
+
+ +

השתמשו במפתח permissions לבקש כוחות מיוחדים עבור ההרחבה שלכם. מפתח זה הינו מערך של מחרוזות, וכל אחת ממחרוזות אלו היא בקשת הרשאה.

+ +

אם תבקשו הרשאות באמצעות מפתח זה, אזי הדפדפן עשוי  לדווח למשתמש/ת בעת ההתקנה שההרבה מבקשת פריבילגיות מסויימות, ולבקש ממנו/ה לאשר כי  ישמח/תשמח להעניק פריבילגיות אלו. הדפדפן עשוי גם להתיר למשתמש/ץ לבדוק פריבילגיות ההרחבה אחרי ההתקנה. כשם שהבקשה להעניק פריבילגיות עשויה להשפיע על נכונות המשתמש/ת להתקין את ההרחבה, בקשת פריבילגיות שווה הפעלה זהירה של שיקול דעת.  לדוגמה, אם תרצו להימנע מלבקש הרשאות לא נחוצות  ותרצו לספק מידע עודות הסיבה לבקשת הרשאות בתיאור המוצר של ההרחבה שלכם. מידע נוסף על העניינים שיש לקחת בחשבון תוכלו למצוא במאמר  Request the right permissions.

+ +

למידע נוסף כיצד לבחון ולצפות בבקשת הרשאות ראו Test permission requests  באתר Extension Workshop site.

+ +

המפתח יכול להכיל שלושה סוגי הרשאות:

+ + + +

הרשאות מארח

+ +

הרשאות מארח מפורטות ב- match patterns, וכל תבנית מזהה קבוצה של כתובות  URLs עבורן ההרחבה מבקשת פריבילגיות נוספות. לדוגמה, בקשת מארח יכולה להיות  "*://developer.mozilla.org/*".

+ +

פריבילגיות נוספות כוללות:

+ + + +

בפירפוקס, מגירסה 56 ואילך, הרחבות מקבלות אוטומטית הרשאות מארח  עבור המקור של עצמן, שהוא בצורה:

+ +
moz-extension://60a20a9b-1ad4-af49-9b6c-c64c98c37920/
+ +

כש-  60a20a9b-1ad4-af49-9b6c-c64c98c37920 הוא המזהה הפנימי של ההרחבה. ההרחבה יכולה לקבל את ה- URL תכנותית על ידי קריאה ל- extension.getURL():

+ +
browser.extension.getURL("");
+// moz-extension://60a20a9b-1ad4-af49-9b6c-c64c98c37920/
+
+ +

הרשאות ממשק פיתוח יישומים

+ +

הרשאות ממשק פיתוח היישומים מפורטות כמילות מפתח, וכל מילת מפתח מהווה שם של  WebExtension API שההרחבה מעוניינת להשתמש בו.

+ +

כעת זמינות מילות המפתח הבאות:

+ + + +

ברוב המקרים ההרשאה רק מעניקה גישה לממשק פיתוח היישומים, עם יוצאי הדופן הבאים:

+ + + +

הרשאת activeTab

+ +

הרשאה זו מצויינת כ- "activeTab". אם להרחבה יש הרשאה זו , אזי בעת תקשורת בין משתמש/ת להרחבה, מוענקות להרחבה פריבילגיות  נוספות ללשונית הפעילה בלבד.

+ +

"תקשורת עם המשתמש" כוללת:

+ + + +

הפריבילגיות הנוספות הן:

+ + + +

הכוונה בהרשאה זו היא לאפשר להרחבות להגשים מקרה שימוש נפוץ, ללא הצורך לתת להן הרשאות בעלות כוח רב מדי. הרשאות רבוטת יהיו מעונינות "לעשות משהו לדף הנוכחי כאשר המשתמש/ת מבקש/ת". לדוגמה, קחו בחשבון הרחבה המבקשת להריץ תסריט בדף הנוכחי כאשר המשתמש/ת מקישה על פעולת דפדפן. אם ההרשאה  activeTab לא הייתה קיימת, ההרחבה הייתה צריכה לבקש את ההרשאת המארח   <all_urls>. אבל זה נותן להרחבה יותר כוח ממה שדרוש לה:  היא הייתה יכולה כעת לבצע תסריטים בכל לשונית, בכל עת שתרצה, במקום רק בלשונית הפעילה ורק בתגובה לפעולת משתמש/ת.

+ +

שימו לב כי תוכלו לקבל גישה רק ללשונית/מידע שכבר שם, כאשר ההתקשרות מצד המשתמש/ת התקיימה (למשל. ההקשה). כאשר הלשונית הפעילה מנווטת למקום אחר, למשל עקב סיום טעינה או אירוע אחר כלשהו, ההרשאה אינה מעניקה לך יותר גישה ללשונית.

+ +

בדרך כלל הלשונית המקבלת את הרשאת activeTab היא רק הלשונית הפעילה באותו רגע, פרט למקרה אחד. ממשק היישומים menus מאפשר להרחבה ליצור פריט תפריט המוצג כאשר המשתמש/ת מקיש/ה הקשת הקשר בלשונית  (כלומר, על הרכיב בפס הלשוניות המשאפשר למשתמש/ת לעבור מלשונית ללשונית). אם המשתמש/ת מקיש/ה על פריט כזה, אזי הרשאת  activeTab מוענקת ללשונית שהוקש עליה, אף אם זו אינה הלשונית הפעילה (נכון לפיירפוקס 63, {{bug(1446956)}}).

+ +

גישה ללוח הגזירים

+ +

קיימות שתי הרשאות המאפשרות להרחבה  לתקשר עם לוח הגזירים:

+ + + +

ראו Interact with the clipboard לכל הפרטים אודות הדבר.

+ +

אחסון ללא הגבלה

+ +

הרשאת unlimitedStorage:

+ + + +

דוגמה

+ +
 "permissions": ["*://developer.mozilla.org/*"]
+ +

לבקשת הרשאה בעלת פריבילגיה  לדפים תחת developer.mozilla.org.

+ +
  "permissions": ["tabs"]
+ +

לבקשת גישה לחלקים בעלי פריבילגיה של ממשק הפיתוח  tabs.

+ +
  "permissions": ["*://developer.mozilla.org/*", "tabs"]
+ +

לבקשת שתי ההרשאות שלעיל.

+ +

תאימות דפדפנים

+ + + +

{{Compat("webextensions.manifest.permissions")}}

diff --git "a/files/he/mozilla/add-ons/webextensions/manifest.json/\327\224\327\250\327\251\327\220\327\225\327\252/index.html" "b/files/he/mozilla/add-ons/webextensions/manifest.json/\327\224\327\250\327\251\327\220\327\225\327\252/index.html" deleted file mode 100644 index 9221f0cf8c..0000000000 --- "a/files/he/mozilla/add-ons/webextensions/manifest.json/\327\224\327\250\327\251\327\220\327\225\327\252/index.html" +++ /dev/null @@ -1,198 +0,0 @@ ---- -title: הרשאות -slug: Mozilla/Add-ons/WebExtensions/manifest.json/הרשאות -tags: - - manifest.json - - הפניה - - הרחבות - - הרחבות רשת - - הרשאות - - תוספים -translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/permissions ---- -

{{AddonSidebar}}

- - - - - - - - - - - - - - - - -
טיפוסArray
חובהלא
דוגמה - 
-"permissions": [
-  "*://developer.mozilla.org/*",
-  "webRequest"
-]
-
- -

השתמשו במפתח permissions לבקש כוחות מיוחדים עבור ההרחבה שלכם. מפתח זה הינו מערך של מחרוזות, וכל אחת ממחרוזות אלו היא בקשת הרשאה.

- -

אם תבקשו הרשאות באמצעות מפתח זה, אזי הדפדפן עשוי  לדווח למשתמש/ת בעת ההתקנה שההרבה מבקשת פריבילגיות מסויימות, ולבקש ממנו/ה לאשר כי  ישמח/תשמח להעניק פריבילגיות אלו. הדפדפן עשוי גם להתיר למשתמש/ץ לבדוק פריבילגיות ההרחבה אחרי ההתקנה. כשם שהבקשה להעניק פריבילגיות עשויה להשפיע על נכונות המשתמש/ת להתקין את ההרחבה, בקשת פריבילגיות שווה הפעלה זהירה של שיקול דעת.  לדוגמה, אם תרצו להימנע מלבקש הרשאות לא נחוצות  ותרצו לספק מידע עודות הסיבה לבקשת הרשאות בתיאור המוצר של ההרחבה שלכם. מידע נוסף על העניינים שיש לקחת בחשבון תוכלו למצוא במאמר  Request the right permissions.

- -

למידע נוסף כיצד לבחון ולצפות בבקשת הרשאות ראו Test permission requests  באתר Extension Workshop site.

- -

המפתח יכול להכיל שלושה סוגי הרשאות:

- - - -

הרשאות מארח

- -

הרשאות מארח מפורטות ב- match patterns, וכל תבנית מזהה קבוצה של כתובות  URLs עבורן ההרחבה מבקשת פריבילגיות נוספות. לדוגמה, בקשת מארח יכולה להיות  "*://developer.mozilla.org/*".

- -

פריבילגיות נוספות כוללות:

- - - -

בפירפוקס, מגירסה 56 ואילך, הרחבות מקבלות אוטומטית הרשאות מארח  עבור המקור של עצמן, שהוא בצורה:

- -
moz-extension://60a20a9b-1ad4-af49-9b6c-c64c98c37920/
- -

כש-  60a20a9b-1ad4-af49-9b6c-c64c98c37920 הוא המזהה הפנימי של ההרחבה. ההרחבה יכולה לקבל את ה- URL תכנותית על ידי קריאה ל- extension.getURL():

- -
browser.extension.getURL("");
-// moz-extension://60a20a9b-1ad4-af49-9b6c-c64c98c37920/
-
- -

הרשאות ממשק פיתוח יישומים

- -

הרשאות ממשק פיתוח היישומים מפורטות כמילות מפתח, וכל מילת מפתח מהווה שם של  WebExtension API שההרחבה מעוניינת להשתמש בו.

- -

כעת זמינות מילות המפתח הבאות:

- - - -

ברוב המקרים ההרשאה רק מעניקה גישה לממשק פיתוח היישומים, עם יוצאי הדופן הבאים:

- - - -

הרשאת activeTab

- -

הרשאה זו מצויינת כ- "activeTab". אם להרחבה יש הרשאה זו , אזי בעת תקשורת בין משתמש/ת להרחבה, מוענקות להרחבה פריבילגיות  נוספות ללשונית הפעילה בלבד.

- -

"תקשורת עם המשתמש" כוללת:

- - - -

הפריבילגיות הנוספות הן:

- - - -

הכוונה בהרשאה זו היא לאפשר להרחבות להגשים מקרה שימוש נפוץ, ללא הצורך לתת להן הרשאות בעלות כוח רב מדי. הרשאות רבוטת יהיו מעונינות "לעשות משהו לדף הנוכחי כאשר המשתמש/ת מבקש/ת". לדוגמה, קחו בחשבון הרחבה המבקשת להריץ תסריט בדף הנוכחי כאשר המשתמש/ת מקישה על פעולת דפדפן. אם ההרשאה  activeTab לא הייתה קיימת, ההרחבה הייתה צריכה לבקש את ההרשאת המארח   <all_urls>. אבל זה נותן להרחבה יותר כוח ממה שדרוש לה:  היא הייתה יכולה כעת לבצע תסריטים בכל לשונית, בכל עת שתרצה, במקום רק בלשונית הפעילה ורק בתגובה לפעולת משתמש/ת.

- -

שימו לב כי תוכלו לקבל גישה רק ללשונית/מידע שכבר שם, כאשר ההתקשרות מצד המשתמש/ת התקיימה (למשל. ההקשה). כאשר הלשונית הפעילה מנווטת למקום אחר, למשל עקב סיום טעינה או אירוע אחר כלשהו, ההרשאה אינה מעניקה לך יותר גישה ללשונית.

- -

בדרך כלל הלשונית המקבלת את הרשאת activeTab היא רק הלשונית הפעילה באותו רגע, פרט למקרה אחד. ממשק היישומים menus מאפשר להרחבה ליצור פריט תפריט המוצג כאשר המשתמש/ת מקיש/ה הקשת הקשר בלשונית  (כלומר, על הרכיב בפס הלשוניות המשאפשר למשתמש/ת לעבור מלשונית ללשונית). אם המשתמש/ת מקיש/ה על פריט כזה, אזי הרשאת  activeTab מוענקת ללשונית שהוקש עליה, אף אם זו אינה הלשונית הפעילה (נכון לפיירפוקס 63, {{bug(1446956)}}).

- -

גישה ללוח הגזירים

- -

קיימות שתי הרשאות המאפשרות להרחבה  לתקשר עם לוח הגזירים:

- - - -

ראו Interact with the clipboard לכל הפרטים אודות הדבר.

- -

אחסון ללא הגבלה

- -

הרשאת unlimitedStorage:

- - - -

דוגמה

- -
 "permissions": ["*://developer.mozilla.org/*"]
- -

לבקשת הרשאה בעלת פריבילגיה  לדפים תחת developer.mozilla.org.

- -
  "permissions": ["tabs"]
- -

לבקשת גישה לחלקים בעלי פריבילגיה של ממשק הפיתוח  tabs.

- -
  "permissions": ["*://developer.mozilla.org/*", "tabs"]
- -

לבקשת שתי ההרשאות שלעיל.

- -

תאימות דפדפנים

- - - -

{{Compat("webextensions.manifest.permissions")}}

diff --git a/files/he/mozilla/add-ons/webextensions/tips/index.html b/files/he/mozilla/add-ons/webextensions/tips/index.html new file mode 100644 index 0000000000..57e18c26fa --- /dev/null +++ b/files/he/mozilla/add-ons/webextensions/tips/index.html @@ -0,0 +1,57 @@ +--- +title: טיפים וטריקים +slug: Mozilla/Add-ons/WebExtensions/טיפום +tags: + - ECMAScript + - אקמהסקריפט + - הרחבות רשת + - טיפים + - טיפים וטריקים + - טריקים +translation_of: Mozilla/Add-ons/WebExtensions/Tips +--- +

{{AddonSidebar}}

+ +

עמוד זה מכיל טיפים וטריקים שוניםהאמורים להיות שימושיים לאנשים רבים המפתחים הרחבות באמצעות ממשקי הפיתוח של הרחבות רשת.

+ +

שימוש בתכונות ג'אווהסקריפט מתקדמות  מתוך ECMAScript 2015 ו-2016

+ +

פיירפוקס תומך בתכונות רבות של  ECMAScript 2015 מלוץ לקופסה. תכונות חדשות ונסיוניות אחדות, לעומת זאת, אינן זמינות לרשת או להרחבות רשת כברירת מחדל.   ,אם ברצונך להשתמש בתכונות אלו, הטוב ביותר יהיה לתרגן את הקוד שלך על ידי שימוש בכלי כמו  Babel.

+ +

יש לתת את הדעת לכך שכל דבר תחת  לשורה זו הינו מידע לא מעודכן והוצא מ-Babel 6.

+ +

Babel מספק טרנספורמציות לרוב הרחב של תכונות ES2015, ומאפשר אותן כברירת מחדל. מאחר ופיירפוקס כבר תומך באופן מלא ברובן, הטוב ביותר יהיה לקנפג את Babel להתעלם מהן. אנו ממליצים ליצור  קובץ .babelrc או מקטע babel בקובץ ה-package.json של הפרוייקט המכיל את הקוד הבא"

+ +
{
+  "env": {
+    "firefox": {
+      "sourceMaps": "inline",
+      "blacklist": [
+        "es5.properties.mutators",
+        "es6.arrowFunctions",
+        "es6.destructuring",
+        "es6.forOf",
+        "es6.parameters",
+        "es6.properties.computed",
+        "es6.properties.shorthand",
+        "es6.spec.symbols",
+        "es6.spread",
+        "es6.tailCall",
+        "es6.templateLiterals",
+        "es6.regex.sticky",
+        "es6.regex.unicode"
+      ]
+    }
+  }
+}
+
+ +

ואז, בשביל לקמפל תסרעט אינדיבידואלי, יש פשוט להריץ:

+ +
BABEL_ENV=firefox babel <filename>
+
+ +

או, כדי לקמפל כל קובץ ג'אווהסקריפט תחת התיקיה src ולמקם את הקבצים המקומפלים ב-compiled, תוך העתקה על קבצים שאינם בג'אווהסקריפט, להריץ

+ +
BABEL_ENV=firefox babel -Dd compiled src
+
diff --git "a/files/he/mozilla/add-ons/webextensions/\327\230\327\231\327\244\327\225\327\235/index.html" "b/files/he/mozilla/add-ons/webextensions/\327\230\327\231\327\244\327\225\327\235/index.html" deleted file mode 100644 index 57e18c26fa..0000000000 --- "a/files/he/mozilla/add-ons/webextensions/\327\230\327\231\327\244\327\225\327\235/index.html" +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: טיפים וטריקים -slug: Mozilla/Add-ons/WebExtensions/טיפום -tags: - - ECMAScript - - אקמהסקריפט - - הרחבות רשת - - טיפים - - טיפים וטריקים - - טריקים -translation_of: Mozilla/Add-ons/WebExtensions/Tips ---- -

{{AddonSidebar}}

- -

עמוד זה מכיל טיפים וטריקים שוניםהאמורים להיות שימושיים לאנשים רבים המפתחים הרחבות באמצעות ממשקי הפיתוח של הרחבות רשת.

- -

שימוש בתכונות ג'אווהסקריפט מתקדמות  מתוך ECMAScript 2015 ו-2016

- -

פיירפוקס תומך בתכונות רבות של  ECMAScript 2015 מלוץ לקופסה. תכונות חדשות ונסיוניות אחדות, לעומת זאת, אינן זמינות לרשת או להרחבות רשת כברירת מחדל.   ,אם ברצונך להשתמש בתכונות אלו, הטוב ביותר יהיה לתרגן את הקוד שלך על ידי שימוש בכלי כמו  Babel.

- -

יש לתת את הדעת לכך שכל דבר תחת  לשורה זו הינו מידע לא מעודכן והוצא מ-Babel 6.

- -

Babel מספק טרנספורמציות לרוב הרחב של תכונות ES2015, ומאפשר אותן כברירת מחדל. מאחר ופיירפוקס כבר תומך באופן מלא ברובן, הטוב ביותר יהיה לקנפג את Babel להתעלם מהן. אנו ממליצים ליצור  קובץ .babelrc או מקטע babel בקובץ ה-package.json של הפרוייקט המכיל את הקוד הבא"

- -
{
-  "env": {
-    "firefox": {
-      "sourceMaps": "inline",
-      "blacklist": [
-        "es5.properties.mutators",
-        "es6.arrowFunctions",
-        "es6.destructuring",
-        "es6.forOf",
-        "es6.parameters",
-        "es6.properties.computed",
-        "es6.properties.shorthand",
-        "es6.spec.symbols",
-        "es6.spread",
-        "es6.tailCall",
-        "es6.templateLiterals",
-        "es6.regex.sticky",
-        "es6.regex.unicode"
-      ]
-    }
-  }
-}
-
- -

ואז, בשביל לקמפל תסרעט אינדיבידואלי, יש פשוט להריץ:

- -
BABEL_ENV=firefox babel <filename>
-
- -

או, כדי לקמפל כל קובץ ג'אווהסקריפט תחת התיקיה src ולמקם את הקבצים המקומפלים ב-compiled, תוך העתקה על קבצים שאינם בג'אווהסקריפט, להריץ

- -
BABEL_ENV=firefox babel -Dd compiled src
-
-- cgit v1.2.3-54-g00ecf