Documentation

Widgets.us.season.ncaab.Scores

us.season.ncaab.scores displays games key scoreboard information broken down by a day (according to local time).

All the properties are optional. By default, widget will render active season and day.

Notes:

  1. Select division, conference and playoffTournament to determine what games are displayed on any given day. The date switcher control will allow you to navigate across every day of the current season. Selecting division narrows the available games and the date switcher to games pertaining to that division. The conference filtering applies only to the regular season, and the playoffTournament applies only to the postseason.
    • By default, when dateFilteringLast is set to false, the date switcher control is applied after the division filter and navigates through all selected division days where games are being played, conference and playoffTournament are applied last and filters the games list for a selected day. The conference selector is displayed and enabled only for regular season games. In the postseason, the conference selector is replaced with the playoffTournament selector. An empty list of games on a particular day is possible - A "No matches available" massage will be displayed in this instance.
    • If dateFilteringLast is set to true, the conference and playoffTournament filters are applied after the division narrows down the date navigation to only display the days in which a team from the specified conference or playoffTournament is playing. Note that the date selector auto selects among the available game days on every conference and playoffTournament change in this scenario. The conference and playoffTournament filters exclude each other. When one is selected, the other resets to all available items.
  2. The widget will automatically flip to next day at end of the current day/start of the next day during auto selecting mode, unless dayFlipUTCHours or dayFlipHoursBefore are set. In that case it will display previous day results until time passes current day dayFlipUTCHours or dayFlipHoursBefore scheduled time of the current day first match.
  3. For older seasons, the auto selected day is always the last day of the season;
  4. Props selectedDate and selectedIdx you to select a particular day to display;
  5. Among all the available league wide scores, a Score widget is used to render each individual game and features the option to include links for navigating to other widgets/content.
  6. Clickable items are teams, filters and links as noted in the Parameters section of the documentation.

new Scores(props)

Parameters
Name Type Description
props object
Properties
Name Type Argument Default Description
seasonId number <optional>

Season id. Can be of any ncaab unique tournament ids.
division string <optional>

Selected division. List of NCAA divisions/conferences
conference string <optional>

Selected conference of the selected division. Applies only to regular season. Empty value means all. List of NCAA divisions/conferences
playoffTournament string <optional>

Selected playoff tournament. Applies only to post-season. Empty value means all. Options are: ncaa, nit, cbi, cit, 'v16`.
selectedIdx number <optional>

Selects particular play day. Index starts with 0.
selectedDate number <optional>

Selects particular play day.
dateFilteringLast boolean <optional>
 'false'

If true date switcher filtering is applied last - selected conference or playoffTournament narrow downs available date switcher play days
showOdds boolean <optional>
 'true'

If false hides odds for all pre-matches.
dayFlipUTCHours number <optional>

Forces flipping to current day's games at a specified time based on UTC time zone, but not before start of the current day (in local time). Although the time is set according to UTC, it will effect end users according to their local time zone. Example: if the current date is 1/19/22, a value of 20 will set flipping at 12:00 for a user in PST time zone, 15:00 for EST and 21:00 for CET. However, using a value of 6 will set flipping at 0:00 PST (rather than 1/18/22 22:00 PST), 1:00 EST and 7:00 CET. An integer between 0 and 23. dayFlipUTCHours has priority over dayFlipHoursBefore.
dayFlipHoursBefore number <optional>

Forces flipping to current day's games a specific number of hours before scheduled time of the first match, but not before start of the current day (in local time). Example: if the first game of the day is at 7:30pm EST, a value of 7 would leave last night's games displayed until 12:30pm EST. An integer between 0 and 23.
disableDateSwitcher boolean <optional>

If true hides division dropdown.
disableDivisionDropdown boolean <optional>

If true hides conference dropdown.
disableConferenceDropdown boolean <optional>

If true hides date switcher control.
disableGameHeader boolean <optional>

if true then headers of games are hidden.
disableGameInfo boolean <optional>

If true hides collapsible content (i.e. game information).
disableGameInfoXSmall boolean <optional>
 'true'

If true hides collapsible content (i.e. game information) on X-Small responsive breakpoint (<321px).
preMatchLinks string <optional>

Comma separated string of link keys for pre-match. Can be undefined, default, preview, boxscore, gametracker, recap, lineups. Entering default is same as entering 'preview', with the exception of soccer - 'preview, lineups'.
liveMatchLinks string <optional>

Comma separated string of link keys for live-match. Can be undefined, default, preview, boxscore, gametracker, recap, lineups. Entering default is same as entering 'boxscore, gametracker'.
postMatchLinks string <optional>

Comma separated string of link keys for post-match. Can be undefined, default, preview, boxscore, gametracker, recap, lineups. Entering default is same as entering 'boxscore, recap'.
border boolean <optional>

If true, draws a border around the widget.
onItemClick function <optional>

Function/event handler. By default, the widget has three click target areas: team, player and filter. The player targets appear in Game information section depending on match status. With preMatchLinks, liveMatchLinks and/or postMatchLinks set the Score widget can get additional targets: preview, boxscore, gametracker, recap, lineups, matchstats links. All targets emit the following match props on click or touch: matchId, sportId, realCategoryId, seasonId, tournamentId, uniqueTournamentId, awayTeamUid, homeTeamUid, matchStatus. Team target adds uniqueTeamId, player target adds playerId. Valid matchStatus values are: pre, live, post.
numFutureDays number <optional>
 0

Deprecated - has no effect. Should extend the scores list in to the feature.
Examples

HTML/Declarative

<div class="sr-widget" data-sr-widget="us.season.ncaab.scores" data-sr-season-id="47474"></div>
<script type="application/javascript" src="https://widgets.media.sportradar.com/uscommon/widgetloader" data-sr-language="en_us" async></script>

JS/Programmatic

<script>
    (function(a,b,c,d,e,f,g,h,i){a[e]||(i=a[e]=function(){(a[e].q=a[e].q||[]).push(arguments)},i.l=1*new Date,i.o=f,
    g=b.createElement(c),h=b.getElementsByTagName(c)[0],g.async=1,g.src=d,g.setAttribute("n",e),h.parentNode.insertBefore(g,h)
    )})(window,document,"script","https://widgets.media.sportradar.com/uscommon/widgetloader","USW", {
        language: 'en_us'
    });
    USW('addWidget', '#sr-widget', 'us.season.ncaab.scores', {seasonId: 56011, selectedDate: '2019-02-14'});
</script>
<div id="sr-widget"></div>

JS/Example of using Event Handlers

<script>
    (function(a,b,c,d,e,f,g,h,i){a[e]||(i=a[e]=function(){(a[e].q=a[e].q||[]).push(arguments)},i.l=1*new Date,i.o=f,
    g=b.createElement(c),h=b.getElementsByTagName(c)[0],g.async=1,g.src=d,g.setAttribute("n",e),h.parentNode.insertBefore(g,h)
    )})(window,document,"script","https://widgets.media.sportradar.com/uscommon/widgetloader","USW", {
        language: 'en_us'
    });
    USW('addWidget', '#sr-widget', 'us.season.ncaab.scores', {preMatchLinks: 'default', liveMatchLinks: 'default', postMatchLinks: 'default', onItemClick: function(type, obj){alert(type + ': ' +JSON.stringify(obj));}});
</script>
<div id="sr-widget"></div>

Examples of onItemClick targets and emitted props

"team", {"matchId":26536476,"seasonId":76813,"tournamentId":79167,"uniqueTournamentId":28370,"realCategoryId":15,"sportId":2,"awayTeamUid":34626,"homeTeamUid":66366,"matchStatus":"post","uniqueTeamId":34626}
"box_score", {"matchId":26536476,"seasonId":76813,"tournamentId":79167,"uniqueTournamentId":28370,"realCategoryId":15,"sportId":2,"awayTeamUid":34626,"homeTeamUid":66366,"matchStatus":"post"}
"match", {"matchId":26536476,"seasonId":76813,"tournamentId":79167,"uniqueTournamentId":28370,"realCategoryId":15,"sportId":2,"awayTeamUid":34626,"homeTeamUid":66366,"matchStatus":"post"}