تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

الفئة google.script.history (واجهة برمجة التطبيقات من جهة العميل)

google.script.history هي واجهة برمجة تطبيقات JavaScript غير متزامنة من جهة العميل يمكنها التفاعل. باستخدام مكدس سجل المتصفح. لا يمكن استخدامها إلا في سياق تطبيق ويب يستخدم IFRAME وهو غير مخصص للاستخدام مع الأشرطة الجانبية ومربعات الحوار في أي وظيفة إضافية أو سياق الحاوية النصية. لمزيد من المعلومات، يُرجى الاطّلاع على دليل استخدام المتصفّح السجلّ في تطبيقات الويب.

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`push(stateObject, params, hash)`	`void`	إرسال كائن الحالة ومعلمات عنوان URL وجزء عنوان URL إلى سجلّ المتصفّح حزمة.
`replace(stateObject, params, hash)`	`void`	لاستبدال الحدث الرئيسي في حزمة سجلّ المتصفّح بعنصر الحالة المقدَّم، عنوان URL المعلمات وجزء عنوان URL.
`setChangeHandler(function)`	`void`	تضبط دالة معاودة الاتصال للاستجابة للتغييرات في سجلّ المتصفّح.

الوثائق التفصيلية

`push(stateObject, params, hash)`

إرسال كائن الحالة ومعلمات عنوان URL وجزء عنوان URL إلى سجلّ المتصفّح حزمة. كائن الحالة هو كائن JavaScript بسيط يحدده المطور ويمكن سيحتوي على أي بيانات ذات صلة بالحالة الحالية للتطبيق. تشبه هذه الطريقة طريقة pushState() JavaScript.

Index.html

var now = new Date();
var state = {
  'timestamp': now.getTime()
};
var params = {
  'options': "none"
};
google.script.history.push(state, params, "anchor1");

المعلمات

الاسم	النوع	الوصف
`stateObject`	`Object`	كائن محدد بواسطة المطوّر يجب أن يكون والمرتبط بحدث سجل المتصفح، والذي يظهر مرة أخرى عند تمييز الحالة. السعر المعتاد يُستخدم لتخزين معلومات حالة التطبيق (مثل بيانات الصفحة) لاستردادها في المستقبل.
`params`	`Object`	كائن يحتوي على معلمات عناوين URL المرتبطة بهذه الحالة. على سبيل المثال، تساوي `{foo: “bar”, fiz: “baz”}` `"?foo=bar&fiz=baz"` بدلاً من ذلك، يمكن استخدام الصفائف: تساوي `{foo: [“bar”, “cat”], fiz: “baz”}` `"?foo=bar&foo=cat&fiz=baz"`. إذا كانت القيم فارغة أو غير محدّدة، لن تتغيّر مَعلمات عناوين URL الحالية. إذا كانت فارغة، سيتم ضبط معلَمات عناوين URL تم محوها.
`hash`	`String`	ظهور جزء عنوان URL للسلسلة بعد الصف الحرف. إذا كانت القيمة فارغة أو غير محددة، لن يتغير الجزء الحالي من عنوان URL. إذا كانت فارغة، سيتم تم محو جزء عنوان URL.

`replace(stateObject, params, hash)`

يستبدل الحدث الرئيسي في حزمة سجلّ المتصفّح بالحالة المقدّمة (من تحديد المطوّر). ومعلمات عنوان URL وجزء عنوان URL. يعد هذا مطابقًا push().

Index.html

var now = new Date();
var state = {
  'timestamp': now.getTime()
};
var params = {
  'options': "none"
};
google.script.history.replace(state, params, "anchor1");

المعلمات

الاسم	النوع	الوصف
`stateObject`	`Object`	كائن محدد بواسطة المطوّر يجب أن يكون والمرتبط بحدث سجل المتصفح، والذي يظهر مرة أخرى عند تمييز الحالة. السعر المعتاد يُستخدم لتخزين معلومات حالة التطبيق (مثل بيانات الصفحة) لاستردادها في المستقبل.
`params`	`Object`	كائن يحتوي على معلمات عناوين URL المرتبطة بهذه الحالة. على سبيل المثال، تساوي `{foo: “bar”, fiz: “baz”}` `"?foo=bar&fiz=baz"` بدلاً من ذلك، يمكن استخدام الصفائف: تساوي `{foo: [“bar”, “cat”], fiz: “baz”}` `"?foo=bar&foo=cat&fiz=baz"`. إذا كانت القيم فارغة أو غير محدّدة، لن تتغيّر مَعلمات عناوين URL الحالية. إذا كانت فارغة، سيتم ضبط معلَمات عناوين URL تم محوها.
`hash`	`String`	ظهور جزء عنوان URL للسلسلة بعد الصف الحرف. إذا كانت القيمة فارغة أو غير محددة، لن يتغير الجزء الحالي من عنوان URL. إذا كانت فارغة، سيتم تم محو جزء عنوان URL.

`setChangeHandler(function)`

تضبط وظيفة معاودة الاتصال للاستجابة للتغييرات في سجلّ المتصفّح. دالة رد الاتصال يجب أن يتم استخدام كائن حدث واحد فقط كوسيطة.

Index.html

google.script.history.setChangeHandler(function (e) {
  console.log(e.state);
  console.log(e.location.parameters);
  console.log(e.location.hash);

  // Adjust web app UI to match popped state here...
});

المعلمات

الاسم	النوع	الوصف
`function`	`Function`	جانب العميل لتشغيلها عند حدث تغيير السجل، باستخدام event object كوسيطة وحيدة.

كائن الحدث

الحقول
`e.state`	عنصر الحالة المرتبط بالحدث الذي تم تمييزه وهذا العنصر مماثل للحالة الذي يُستخدم في الدالة push() المقابلة أو replace() الذي أضاف حالة انبثاق إلى مكدس التاريخ. {"page":2, "name":"Wilbur"}
`e.location`	عنصر موقع المرتبط بالحدث المفرقع {"hash":"", "parameter":{"name": "alice", "n": "1"}, "parameters":{"name": ["alice"], "n": ["1", "2"]}}