Введение в классы Apple

Начиная с OS X v10.4.3, Apple предоставляет Вам ряд классов JavaScript, упрощающих включать общий контроль и утилиты в Ваш виджет. Эти классы, названные Классами Apple, включают:

Классы Apple найдены в /System/Library/WidgetResources/AppleClasses/ и может использоваться оттуда или из Вашего виджета, в зависимости от того, является ли обратная совместимость беспокойством.

Включая класс Apple

Существует два способа использовать любой Класс Apple в Вашем виджете: так, чтобы Ваш виджет был обратно совместим с версиями OS X 10.4 к 10.4.2, или таким образом, Ваш виджет работает на OS X v10.4.3 и позже.

Назад совместимое использование

Так как Классы Apple включены с OS X начиная с версии 10.4.3, можно хотеть использовать класс, все же развертывают виджет на версиях OS X 10.4 к 10.4.2. Чтобы сделать это, выполните эти шаги:

  1. Скопируйте необходимые Классы Apple из /System/Library/WidgetResources/ в папку, названную AppleClasses, на верхнем уровне пакета Вашего виджета.

  2. В Вашем основном файле HTML включайте необходимые классы с помощью локального пути к файлу, как это:

    <script type='text/javascript' src='AppleClasses/AppleInfoButton.js' charset='utf-8'/>

  3. В Вашем Info.plist информационный файл списка свойств, включайте ключ BackwardsCompatibleClassLookup и набор его значение к булеву значению YES.

Путем копирования необходимых Классов Apple внутри в виджете и включая локальную копию в основном файле HTML, виджет использует локальные копии, гарантируя, что классы доступны виджету независимо от того, на чем работает версия OS X v.10.4 виджет.

Обратите внимание на то, что ключ Info.plist BackwardsCompatibleClassLookup имеет особое значение на OS X v.10.4.3 и позже. Когда Инструментальная панель видит этот ключ и любого <script> тег, включающий файл с AppleClasses/ как первая часть его пути, это автоматически предоставляет Вашему виджету соответствующую версию, расположенную в /System/Library/WidgetResources/ вместо локальной копии. Это позволяет Вам использовать самую актуальную версию Класса Apple в будущих версиях OS X при сохранении обратной совместимости с более ранними версиями OS X v.10.4.

Для Виджетов на OS X v.10.4.3 и Позже

Если Вы намереваетесь для своего виджета только работать над версией 10.4.3 OS X и позже, можно опустить любые шаги обратной совместимости и просто включать файлы JavaScript для необходимых классов в их расположении в /System/Library/WidgetResources/, как это:

<script type='text/javascript' src='/System/Library/WidgetResources/AppleClasses/AppleInfoButton.js' charset='utf-8'/>

Используя класс Apple

Считайте эти статьи для узнавания больше о Классах Apple и как использовать их:

Класс Apple

Корреляция статей

AppleScrollArea и AppleScrollbar, используемый для создания области с содержанием с возможностью прокрутки.

Используя области прокрутки

AppleSlider, используемый для добавления ползунка управляют к виджету.

Используя ползунок Apple

AppleAnimator, автоматический таймер, которые генерируют значения на основе предопределенной кривой.

Используя анимацию

AppleButton, используемый прежде всего для добавления стандарта разработанная стеклом кнопка к виджету.

Используя Кнопку Apple, Спины Виджета и Предпочтения (в частности В Вашем Файле HTML и В Ваших Разделах файлов JavaScript)

AppleInfoButton, используемый на передней стороне виджета, чтобы показать, что виджет имеет спину. Когда щелкнувшийся, это переворачивает виджет.

Спины виджета и Предпочтения (в частности В Вашем Файле HTML и В Ваших Разделах файлов JavaScript)