הגדרה של סרגל האפליקציות

רוצה לנסות את שיטת הכתיבה?
'Jetpack פיתוח נייטיב' היא ערכת הכלים המומלצת לממשק המשתמש ל-Android. מידע על הוספת רכיבים לכתיבה.

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

תמונה שבה מוצג סרגל האפליקציות באפליקציה 'עכשיו' ב-Android
איור 1. סרגל אפליקציות עם סמל פעולה ב'עכשיו ב-Android' אפליקציה.

לכל הפעילויות שמשתמשות בעיצוב ברירת המחדל יש ActionBar כאפליקציה בר. תכונות של סרגל האפליקציות מתווספות ל-ActionBar המקורי כשמשתמשים גרסאות של Android. כתוצאה מכך, ההתנהגות של התוכן המקורי ActionBar תהיה שונה. בהתאם לגרסת Android שמותקנת במכשיר.

מצד שני, תכונות מתווספות לגרסה של ספריית AndroidX AppCompat Toolbar, כלומר, התכונות האלה זמינות במכשירים שמשתמשים בספריות AndroidX.

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

הוספת סרגל כלים לפעילות

בשלבים הבאים מוסבר איך להגדיר Toolbar כסרגל האפליקציות של הפעילות שלך:
  1. מוסיפים את ספריית AndroidX לפרויקט, כפי שמתואר ב- סקירה כללית על AndroidX.
  2. מוודאים שהפעילות ארוכה AppCompatActivity:

    Kotlin

    class MyActivity : AppCompatActivity() {
      // ...
    }
    

    Java

    public class MyActivity extends AppCompatActivity {
      // ...
    }
    
  3. בקובץ המניפסט של האפליקציה, יש להגדיר את <application> לשימוש באחד מהרכיבים של AppCompat NoActionBar נושאים כמו בדוגמה הבאה. שימוש באחד מהנושאים האלה מונע להשתמש במחלקה המקורית של ActionBar כדי לספק את סרגל האפליקציות.
    <application
        android:theme="@style/Theme.AppCompat.Light.NoActionBar"
        />
    
  4. צריך להוסיף Toolbar לפריסת הפעילות. לדוגמה, קוד הפריסה מוסיף Toolbar ומעניק לו מראה של צף מעל הפעילות:
    <androidx.appcompat.widget.Toolbar
       android:id="@+id/my_toolbar"
       android:layout_width="match_parent"
       android:layout_height="?attr/actionBarSize"
       android:background="?attr/colorPrimary"
       android:elevation="4dp"
       android:theme="@style/ThemeOverlay.AppCompat.ActionBar"
       app:popupTheme="@style/ThemeOverlay.AppCompat.Light"/>
    

    לצפייה מפרט של עיצוב חומר כדי לקבל המלצות לגבי גובה הסרגל של האפליקציה.

    למקם את סרגל הכלים בחלק העליון של הפעילות. layout, מאחר שמשתמשים אותו בתור סרגל אפליקציות.

  5. בקטע של הפעילות onCreate() נקראת 'פעילות' setSupportActionBar() ומעבירים את סרגל הכלים של הפעילות, כפי שמוצג בדוגמה הבאה. הזה הפרמטר הזה מגדיר את סרגל הכלים כסרגל האפליקציות של הפעילות.

    Kotlin

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_my)
        // The Toolbar defined in the layout has the id "my_toolbar".
        setSupportActionBar(findViewById(R.id.my_toolbar))
    }
    

    Java

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_my);
        Toolbar myToolbar = (Toolbar) findViewById(R.id.my_toolbar);
        setSupportActionBar(myToolbar);
    }
    

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

שימוש בשיטות השירות של סרגל האפליקציות

לאחר הגדרת סרגל הכלים כסרגל אפליקציות של פעילות, יש לך גישה לכלי השירות שקיימות בספריית AndroidX ActionBar בכיתה. בצורה הזו תוכלו לבצע פעולות שימושיות, כמו הסתרה והצגה של סרגל האפליקציה.

כדי להשתמש ב-methods של ActionBar, צריך לקרוא לפעילות getSupportActionBar() . השיטה הזו מחזירה הפניה לאובייקט ActionBar של AppCompat. אחרי שמקבלים את ההפניה, אפשר לקרוא לכל אחת מהשיטות של ActionBar כדי לכוונן את סרגל האפליקציות. לדוגמה, כדי להסתיר את סרגל האפליקציות, התקשר ActionBar.hide()